table of contents
NETWORKMANAGER(8) | Network management daemons | NETWORKMANAGER(8) |
NAME¶
NetworkManager - network management daemon
SYNOPSIS¶
NetworkManager [OPTIONS...]
DESCRIPTION¶
The NetworkManager daemon attempts to make networking configuration and operation as painless and automatic as possible by managing the primary network connection and other network interfaces, like Ethernet, Wi-Fi, and Mobile Broadband devices. NetworkManager will connect any network device when a connection for that device becomes available, unless that behavior is disabled. Information about networking is exported via a D-Bus interface to any interested application, providing a rich API with which to inspect and control network settings and operation.
DISPATCHER SCRIPTS¶
NetworkManager will execute scripts in the /etc/NetworkManager/dispatcher.d directory or subdirectories in alphabetical order in response to network events. Each script should be a regular executable file owned by root. Furthermore, it must not be writable by group or other, and not setuid.
Each script receives two arguments, the first being the interface name of the device an operation just happened on, and second the action. For device actions, the interface is the name of the kernel interface suitable for IP configuration. Thus it is either VPN_IP_IFACE, DEVICE_IP_IFACE, or DEVICE_IFACE, as applicable. For the hostname and connectivity-change actions it is always "none".
The actions are:
pre-up
up
pre-down
down
vpn-pre-up
vpn-up
vpn-pre-down
vpn-down
hostname
dhcp4-change
dhcp6-change
connectivity-change
The environment contains more information about the interface and the connection. The following variables are available for the use in the dispatcher scripts:
NM_DISPATCHER_ACTION
CONNECTION_UUID
CONNECTION_ID
CONNECTION_DBUS_PATH
CONNECTION_FILENAME
CONNECTION_EXTERNAL
DEVICE_IFACE
DEVICE_IP_IFACE
IP4_ADDRESS_N
IP4_NUM_ADDRESSES
IP4_GATEWAY
IP4_ROUTE_N
IP4_NUM_ROUTES
IP4_NAMESERVERS
IP4_DOMAINS
DHCP4_<dhcp-option-name>
IP6_<name> and DHCP6_<name>
CONNECTIVITY_STATE
In case of VPN, VPN_IP_IFACE is set, and IP4_*, IP6_* variables with VPN prefix are exported too, like VPN_IP4_ADDRESS_0, VPN_IP4_NUM_ADDRESSES.
Dispatcher scripts are run one at a time, but asynchronously from the main NetworkManager process, and will be killed if they run for too long. If your script might take arbitrarily long to complete, you should spawn a child process and have the parent return immediately. Scripts that are symbolic links pointing inside the /etc/NetworkManager/dispatcher.d/no-wait.d/ directory are run immediately, without waiting for the termination of previous scripts, and in parallel. Also beware that once a script is queued, it will always be run, even if a later event renders it obsolete. (Eg, if an interface goes up, and then back down again quickly, it is possible that one or more "up" scripts will be run after the interface has gone down.)
OPTIONS¶
The following options are understood:
--version | -V
--help | -h
--no-daemon | -n
--debug | -d
--pid-file | -p
--state-file
--config
--configure-and-quit [initrd]
--plugins
--log-level
--log-domains
--print-config
UDEV PROPERTIES¶
udev(7) device manager is used for the network device discovery. The following property influences how NetworkManager manages the devices:
NM_UNMANAGED
SIGNALS¶
NetworkManager process handles the following signals:
SIGHUP
SIGUSR1
SIGUSR2
An alternative to a signal to reload configuration is the Reload D-Bus call. It allows for more fine-grained selection of what to reload, it only returns after the reload is complete, and it is guarded by PolicyKit.
DEBUGGING¶
The following environment variables are supported to help debugging. When used in conjunction with the --no-daemon option (thus echoing PPP and DHCP helper output to stdout) these can quickly help pinpoint the source of connection issues. Also see the --log-level and --log-domains to enable debug logging inside NetworkManager itself.
NM_PPP_DEBUG: When set to anything, causes NetworkManager to turn on PPP debugging in pppd, which logs all PPP and PPTP frames and client/server exchanges.
BUGS¶
Please report any bugs you find in NetworkManager at the NetworkManager bug tracker[1].
SEE ALSO¶
NetworkManager home page[2], NetworkManager.conf(5), nmcli(1), nmcli-examples(7), nm-online(1), nm-settings(5), nm-applet(1), nm-connection-editor(1), udev(7)
NOTES¶
- 1.
- NetworkManager bug tracker
- 2.
- NetworkManager home page
NetworkManager 1.18.8 |